Custom প্লাগইন তৈরি এবং ব্যবহারের উদাহরণ

Cordova প্ল্যাটফর্মে কাস্টম প্লাগইন তৈরি করা এবং ব্যবহার করা একটি সাধারণ প্রক্রিয়া। যখন আপনি এমন কিছু ফিচার চান যা Cordova এর ডিফল্ট প্লাগইন সমর্থন করে না, তখন আপনি একটি কাস্টম প্লাগইন তৈরি করতে পারেন। এই প্লাগইনটি আপনার প্রয়োজন অনুযায়ী নেটিভ কোড (Java/Kotlin/Swift/Objective-C) ব্যবহার করে কাজ করতে পারে এবং তারপর জাভাস্ক্রিপ্টের মাধ্যমে এটি অ্যাক্সেস করা যায়।

১. Custom প্লাগইন তৈরি করার প্রক্রিয়া

ধাপ ১: নতুন প্লাগইন তৈরি করা

Cordova CLI ব্যবহার করে নতুন প্লাগইন তৈরি করতে নিম্নলিখিত কমান্ড ব্যবহার করুন:

cordova plugin create myPlugin org.example.myPlugin MyPlugin

এটি একটি নতুন প্লাগইন ফোল্ডার তৈরি করবে যেখানে আপনার প্লাগইন সম্পর্কিত সব ফাইল থাকবে।

ধাপ ২: প্লাগইন কোড লেখা

আপনার প্লাগইনটি Java (Android এর জন্য) বা Swift/Objective-C (iOS এর জন্য) এ নেটিভ কোড লিখবে। উদাহরণস্বরূপ, যদি আপনার প্লাগইনটি ডিভাইসের ব্যাটারি স্তর দেখতে চায়, তাহলে Android এবং iOS এর জন্য আলাদা কোড থাকবে।

Android প্ল্যাটফর্মে (Java):

package org.example.myPlugin;

import org.apache.cordova.CallbackContext;
import org.apache.cordova.CordovaPlugin;
import org.apache.cordova.PluginResult;
import android.content.Context;
import android.os.BatteryManager;

public class MyPlugin extends CordovaPlugin {
    @Override
    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
        if (action.equals("getBatteryLevel")) {
            Context context = cordova.getActivity().getApplicationContext();
            BatteryManager batteryManager = (BatteryManager) context.getSystemService(Context.BATTERY_SERVICE);
            int level = batteryManager.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY);
            callbackContext.success(level + "%");
            return true;
        }
        return false;
    }
}

iOS প্ল্যাটফর্মে (Swift):

import Cordova

@objc(MyPlugin) class MyPlugin : CDVPlugin {
    @objc func getBatteryLevel(_ command: CDVInvokedUrlCommand) {
        let level = UIDevice.current.batteryLevel * 100
        let pluginResult = CDVPluginResult(status: CDVCommandStatus_OK, messageAs: "\(Int(level))%")
        self.commandDelegate.send(pluginResult, callbackId: command.callbackId)
    }
}

ধাপ ৩: প্লাগইন তথ্য যোগ করা

প্লাগইনের plugin.xml ফাইলে প্লাগইনের বিবরণ এবং ব্যবহারযোগ্য কমান্ড যুক্ত করুন:

<plugin id="org.example.myPlugin" version="1.0.0">
    <name>MyPlugin</name>
    <description>Custom plugin to get battery level</description>
    <platform name="android">
        <source-file src="src/android/MyPlugin.java" target-dir="src/org/example/myPlugin"/>
    </platform>
    <platform name="ios">
        <source-file src="src/ios/MyPlugin.swift" target-dir="src/org/example/myPlugin"/>
    </platform>
    <js-module src="www/myPlugin.js">
        <clobbers target="cordova.plugins.MyPlugin"/>
    </js-module>
</plugin>

ধাপ ৪: প্লাগইন JS ফাইল তৈরি

এখন, আপনার প্লাগইনটি JavaScript মাধ্যমে অ্যাক্সেস করতে হবে। www/myPlugin.js ফাইলে নিম্নলিখিত কোড যোগ করুন:

var exec = require('cordova/exec');

var myPlugin = {
    getBatteryLevel: function(success, error) {
        exec(success, error, "MyPlugin", "getBatteryLevel", []);
    }
};

module.exports = myPlugin;

ধাপ ৫: প্লাগইন ইনস্টল এবং ব্যবহার

প্লাগইনটি ইনস্টল করার জন্য, আপনার Cordova প্রজেক্টে নিম্নলিখিত কমান্ড চালান:

cordova plugin add /path/to/your/plugin

এখন, আপনার অ্যাপ্লিকেশনে এই প্লাগইনটি ব্যবহার করতে পারেন:

cordova.plugins.MyPlugin.getBatteryLevel(function(batteryLevel) {
    console.log("Battery Level: " + batteryLevel);
}, function(error) {
    console.error("Error: " + error);
});

২. Custom প্লাগইন ব্যবহারের উদাহরণ

ধরা যাক, আপনি একটি প্লাগইন তৈরি করেছেন যা ডিভাইসের ব্যাটারি স্তর রিটার্ন করে। নিচে একটি উদাহরণ দেওয়া হলো, যেখানে আমরা এই প্লাগইনটি ব্যবহার করে ব্যাটারি স্তর প্রদর্শন করব।

এপ্লিকেশন কোড:

document.addEventListener("deviceready", function() {
    cordova.plugins.MyPlugin.getBatteryLevel(function(batteryLevel) {
        alert("Battery Level: " + batteryLevel);
    }, function(error) {
        alert("Error: " + error);
    });
});

এই কোডে, deviceready ইভেন্টটি নিশ্চিত করে যে আপনার অ্যাপ্লিকেশনটি ডিভাইসের সাথে প্রস্তুত এবং কাস্টম প্লাগইনটি কাজ করতে পারে।

সারাংশ

1. Custom প্লাগইন তৈরি: Cordova প্লাগইন তৈরি করতে, আপনি Java বা Swift/Objective-C এ কোড লিখবেন যা নির্দিষ্ট নেটিভ কার্যক্ষমতা প্রদান করবে এবং JavaScript এর মাধ্যমে অ্যাক্সেসযোগ্য হবে।
2. প্লাগইন ইনস্টল করা: প্লাগইন তৈরি করার পর, এটি আপনার Cordova প্রজেক্টে ইনস্টল করতে হবে এবং তারপর এটি ব্যবহার করতে হবে।
3. JS ফাইল তৈরি: প্লাগইনকে JavaScript এর মাধ্যমে অ্যাক্সেসযোগ্য করতে www/myPlugin.js ফাইল তৈরি করতে হবে।

এভাবে আপনি Cordova এ কাস্টম প্লাগইন তৈরি এবং ব্যবহার করতে পারবেন।